home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / visds / readme.txt < prev    next >
Encoding:
Text File  |  1999-05-02  |  21.1 KB  |  519 lines
  1. Visual DialogScript version 3.01 Release Notes                  03 may 1999
  2. ===========================================================================
  3.  
  4. Welcome to Visual DialogScript!
  5. -------------------------------
  6.  
  7. Thank you for trying Visual DialogScript, the simple program development
  8. tool for Microsoft Windows. Please take a few moments to read this file.
  9. It contains important information both for new users and upgraders from
  10. earlier versions of the product.
  11.  
  12. What is Visual DialogScript?
  13. ----------------------------
  14.  
  15. Visual DialogScript is a programming language and development environment
  16. that has been designed to enable you quickly to develop simple dialog-based
  17. programs or batch files for Windows 95 with the same ease as you might have
  18. written a batch file or a Basic program for DOS.
  19.  
  20. The DialogScript language is easy to learn and similar to, though much more
  21. powerful than, a batch language or macro language. Visual DialogScript also
  22. includes visual tools: a Dialog Editor for designing dialog boxes visually,
  23. and an Icon Editor for creating graphical icons for your programs.  There
  24. is also a Dialog Wizard which generates the code automatically from your
  25. visually designed dialog. Many useful DialogScript programs can be written
  26. in a matter of minutes!
  27.  
  28. If you are new to Visual DialogScript, try the short Tutorial, then take a
  29. few minutes to read through the User Guide section of the online manual.
  30. This explains how the program works and covers basic concepts of the
  31. DialogScript programming language. There are also several examples which
  32. you can try out by cutting the code from the help file, pasting it into the
  33. editor window, and running it.
  34.  
  35. System Requirements
  36. -------------------
  37.  
  38. Visual DialogScript requires the following minimum system
  39. specification:
  40.  
  41. - A Pentium 75MHz with 16MB RAM, 2MB hard disk space, color VGA display,
  42.   mouse or compatible pointing device
  43.  
  44. - Windows 95 or NT 4.0.
  45.  
  46. Specifications for programs created with Visual DialogScript :
  47.  
  48. - Any system running Windows 95 or NT 4.0. 
  49.  
  50.  
  51. Removing Visual DialogScript from your system
  52. ---------------------------------------------
  53.  
  54. Visual DialogScript can be removed either by the uninstall applet from the
  55. control panel or by the shortcut " Uninstall Visual DialogScript " in its
  56. Folder.
  57.  
  58. Registering Visual DialogScript
  59. -------------------------------
  60.  
  61. We hope you like Visual DialogScript and find it useful.  However, please
  62. be aware that Visual DialogScript is not free or public domain software.
  63.  
  64. You are granted a license giving limited rights to use the software.  The
  65. conditions of use are described in the License Agreement in the online
  66. help. Basically, you are allowed up to 28 days to use the software for the
  67. purpose of evaluating it. After that 28 days, or once you begin using it
  68. for other purposes, whichever is the shorter, you must purchase a full
  69. license for the software. You are violating criminal and intellectual
  70. property laws if you do not do so.
  71.  
  72. This version of Visual DialogScript is fully functional.  However, while it
  73. remains unregistered the software can't compile scripts.
  74.  
  75. This program can be registered through our agents RegNet - The Registration
  76. Network.  RegNet can be located on the World Wide Web at the following URL:
  77.  
  78.     http://www.swregnet.com/
  79.  
  80. Registration costs $99.00 US. 
  81.  
  82. You can register online using your credit card.  RegNet offers secure transactions
  83. for users of NetScape or Microsoft Internet Explorer 3 or higher.
  84. To go to the registration page for Visual DialogScript 3 go to:
  85.  
  86.     http://www.reg.net/product.asp?ID=4240    
  87.  
  88. Alternatively, you can send a check or money order (in US dollars drawn on a US bank),
  89. made payable to Wintronix, Inc to:
  90.  
  91. RegNet
  92.     24303 Walnut Street
  93.     Suite 200
  94.     Newhall, CA  91321
  95.     U.S.A.
  96.  
  97. You can also call the toll-free number 1 800 WWW2REG (1 800 999-2734).  
  98. Callers from outside the US should call  (661) 288-1827.
  99. Upon registration (allow up to 1 working day for your registration to be processed)
  100. you will receive your personal registration key.  This will be sent by email if an
  101. email address was specified when registering.
  102.  
  103. When you receive your registration key, place it in the program's main directory 
  104. (e.g: c:\program files\Visual DialogScript). The software will then behave as a 
  105. fully licensed version.
  106.  
  107. Technical support
  108. -----------------
  109.  
  110. Support for Visual DialogScript is provided via email to:
  111.  
  112.     support@dialogscript.com
  113.  
  114. Two levels of support are offered.
  115.  
  116. Free pre- and post-sales support covers Installation problems, bug reports
  117. and the provision of workarounds (if possible) where a bug is identified,
  118. and simple questions, like "Can you do this using VDS?" 
  119.  
  120. An extra-cost support plan is also offered which provides support cover for
  121. the following areas:
  122.  
  123. -    Help achieving a specific task (we will write sections of script
  124.     code)
  125. -    Help debugging a script that won't work
  126. -    Help writing a script (within the limit of two hours worth of work)
  127. -    The provision of interim upgrades of the VDS software by email
  128.     where a bug prevents a script from working or necessitates an
  129.     inconvenient workaround (other customers must wait for the fixed
  130.     version to be generally released.) 
  131.  
  132. For more information about support, visit the support page on our Web site.
  133.  
  134. Whatever your support problem, please help us to help you by including the
  135. following information in your request:
  136.  
  137. -    Your name and company (as specified on registration)
  138. -    The product name and version number (from the About box)
  139. -    The version of Windows you are using
  140. -    The sequence of events (or a section of script code) which will
  141.     enable us to reproduce the problem.
  142.  
  143. Please do NOT send large screendump files as enclosures as your message may
  144. be deleted.
  145.  
  146. Known problems
  147. --------------
  148.  
  149. * The Help menu options to connect to our Web site and to register online
  150.   will only work if your system is set up to automatically associate your
  151.   Web browser with an Internet URL.
  152.  
  153.  
  154. Changes in version 3.01
  155. -----------------------
  156.  
  157. New features:
  158. -------------
  159.  
  160. * Added NOTITLE style for dialog, creates non-movable window with
  161. no title bar.
  162.  
  163. * Added two options to the EXITWIN command:
  164.   LOGOFF - logs the user off the system (the program that issued
  165.            the command appears to remain running)
  166.   FORCE  - forcibly shuts down Windows without allowing programs
  167.            to display any "OK to close" messages or similar.
  168.  
  169. General Changes:
  170. ----------------
  171.  
  172. * Corrected bug that prevented .ICO files from being loaded into a
  173. BITMAP dialog element. As a by-product of this, it is now possible
  174. to include icons in a .DSR and load them by specifying the byte
  175. offset where they begin.
  176.  
  177. * DIALOG CLEAR,<bitmap> now actually clears the bitmap instead of
  178. hiding it.
  179.  
  180. IDE changes
  181. -----------
  182.  
  183. * Fixed bug that caused default registry key setting from OPTION
  184.   REGKEY to be reset when stepping through script with debugger.
  185.  
  186. * Fixed bug that caused default INI file section name to be wrong.
  187.  
  188. * More logical operation of the IDE script run/debug controls:
  189.   - Run and Debug now always start script from line 1.
  190.   - Continue will continue in the mode (i.e. run or debug) in use
  191.     when the script was stopped.
  192.  
  193. * Fixed bug where script path was not added to history list when
  194.     File, New executed.
  195.  
  196. * Fixed bug that allowed compiler to try to create EXE in a non-
  197.     existant directory if this was specified in the .DSP file.
  198.  
  199. * Added editor context menu: Clear All Bookmarks
  200.  
  201. Dialog Designer changes
  202. -----------------------
  203.  
  204. * Fixed bug that when elements are on top of a GROUP or TAB element
  205. and that element is moved, the positions of the other elements were
  206. not always updated.
  207.  
  208. Changes in version 3.0
  209. -----------------------
  210.  
  211. Important note:
  212.  
  213. VDS 3 is a major new version. There are many changes compared to VDS 2. 
  214. In the interests of improving the language and the features it offers, some changes 
  215. have been made that will necessitate rewriting parts of existing scripts. 
  216. The most obvious example of this is the DIALOG syntax and the reversing of the first 
  217. two parameters of the LIST command. These changes were made to obtain greater consistency 
  218. in the DialogScript language. Other anomalies, such as the format used for lists of 
  219. binary values by the REGISTRY command and @REGREAD function, have been corrected.
  220.  
  221. A Script Converter tool is provided which will make most of the mechanical changes 
  222. needed to get VDS 2 scripts running under VDS 3.
  223.  
  224. Because the script engine has undergone major rewriting there may be more subtle 
  225. differences such as undocumented features which people have previously exploited 
  226. that now longer work the same as before. Therefore it is recommended that all scripts, 
  227. even if they use commands that have not apparently changed, be re-tested thoroughly 
  228. under the new version.
  229.  
  230. New features:
  231.  
  232. * Added multi dialog support. Complete modification of the DIALOG command have been done.
  233.   Browse the help file to discover the new syntax.
  234. * Added TAB dialog element.
  235. * Added GROUP dialog element.
  236. * Added MENU dialog element.
  237. * Added BITBTN dialog element, a flat Explorer-type button.
  238. * Added a lot of new styles for some dialog elements. One of the most expected is the MULTI
  239.   for the EDIT dialog element (multi lines edit box). check the help file for more informations.
  240. * Added 64 Long name variables of unlimited lenght
  241. * Added @DLGPOS function to returns the size and position of a given element.
  242. * Added @FEXP floating-point function. Returns the value exp(value).
  243. * Added @FLN  floating-point function. Returns the value ln(value).
  244. * Added @LOWER function. The complement of @upper
  245. * Added @MOD math function. Returns the value <value1> modulo <value2>.
  246. * Added @MOUSEPOS Returns the X, Y co-ordinates of the mouse pointer, field separated.
  247. * Added @TEXT function. Gets the whole text of a string list into a variable. 
  248. * Added @WINDOW function. Returns the window id of a window related to <window> 
  249.   in a manner specified by the second argument.
  250.  
  251. Changes:
  252.  
  253. * @DATETIME. If no format is specified, the value returned is a floating point.
  254. * @DIRDLG. The second argument is now a directory path
  255. * @FILEDLG. This function now has an extra (fourth) parameter MULTI.
  256. * @ITEM. This function now has an optional second parameter ( @item(i,x) ) 
  257.   allowing you to retrieve an item from a list randomly without having 
  258.   to seek to that item first. 
  259. * @REGREAD. This function now returns binary key values as a string of numbers 
  260.   separated by fieldsep.
  261. * @VOLINFO. This function has two new flags. The Y flag returns a text string 
  262.   describing the file system type (for example, FAT32, NTFS.) The Z flag returns 
  263.   the hard disk serial number. The F and S flags which return the free space and 
  264.   total size of a drive return an incorrect result for volumes larger than 2GB in 
  265.   earlier versions of Windows 95. This is because of a bug in Windows 95. The function 
  266.   has been modified to use a new function present only in Windows 95 OSR2 or later and 
  267.   Windows NT 4.0 so that it reports these values correctly when run on those systems.
  268. * BEEP. This command can optionally accept an argument, an integer value corresponding 
  269.   to the constants permitted in the MessageBeep API.
  270. * DIRECTORY. A new operation RENAME has been added
  271. * LIST. This command has changed in one major respect which is that the order of parameters 
  272.   of this command has been changed. Parameter 1 and parameter 2 are swapped round. 
  273. * REGISTRY. REGISTRY WRITE now supports an optional fifth parameter, 
  274.   which can be BINARY or DWORD.
  275. * TITLE. Minor change. See the help file.
  276. * WAIT. The value for the timer interval may now be a floating-point value.
  277. * Complete rewrite of the FILE command. Browse the help file to discover the new possibilities.
  278. * Removed BREAK (Now it's a functionality from the IDE)
  279.  
  280. There are a lot of others changes in this version. Take a look at the help file
  281. to know more about the VDS 3 improvements.
  282.  
  283. Changes in version 2.50
  284. -----------------------
  285.  
  286. Changes:
  287.  
  288. * Added additional parameters to the LINK command.
  289. * Fixed minor problems.
  290.  
  291. Changes in version 2.20
  292. -----------------------
  293.  
  294. New features:
  295.  
  296. * Added @LOWER function to convert string to lower case.
  297. * @EQUAL function now treats numeric strings as numbers, and has new EXACT
  298.   option for case-sensitive comparisons.
  299. * New functions @STRINS and @STRDEL implemented to allow insertion and
  300.   deletion of characters within strings.
  301. * The @INPUT function now has a PASSWORD option which causes the input
  302.   text to be shown as asterisks.
  303. * The LIST command has a new WINLIST option that creates a list of all the
  304.   main windows in the system.
  305. * A new LINK command lets you create Windows 95 shortcuts (32-bit only).
  306. * A new L pseudo-attribute lets you find out the target of a shortcut
  307.   using the @FILE function.
  308. * You can now have conditional breakpoints by specifying a function after
  309.   the BREAK command.
  310. * A new OPTION, SCALE, will cause a dialog to scale itself in accordance
  311.   with the metrics of the user's screen.
  312.  
  313. Changes:
  314.  
  315. * All items in the Tools menu (including the default ones) are now
  316.   controlled by the tool manager. This means you will need to run
  317.   SETUP.EXE to create Registry or INI file entries for the included tools.
  318. * Fixed problem with window IDs being returned incorrectly from some
  319.   window functions.
  320. * Either or both values in an @EQUAL or @GREATER comparison can now be null
  321.   without causing a 'Missing parameter' error.
  322.  
  323. Changes in version 2.12
  324. -----------------------
  325.  
  326. New features:
  327.  
  328. * Added error trapping capabilities. OPTION ERRORTRAP,<label> defines a
  329.   label to jump to if an error occurs, and the @ERROR function lets you
  330.   determine the error code, line number at which the error occurred and
  331.   the contents of the line.
  332.  
  333. * Added the floating point functions @FATN, @FCOS, @FSIN, @FSQT.
  334.  
  335. * Added the @BOTH function which returns a 'true' result only if both of
  336.   its arguments are true.
  337.  
  338. * Added the @SENDMSG function which enables a script program to send
  339.   Windows messages to other windows.
  340.  
  341. Changes:
  342.  
  343. * Increased the number of extension DLLs that can be used (ref: EXTERNAL
  344.   command) to 4.
  345.  
  346. * Fixed problem with message boxes and input boxes not appearing in front
  347.   of dialogs created with ONTOP dialog type.
  348.  
  349. * (16-bit) Changed the name of some of the accessory programs to avoid
  350.   conflict if it is installed into the same directory as the 32-bit
  351.   version.
  352.  
  353. Changes in version 2.11
  354. -----------------------
  355.  
  356. New features:
  357.  
  358. * Added command line compile option. This feature is provided to enable
  359.   those users who have developed scripts which have become too large for
  360.   the integrated editor to handle to compile them. It also lets you do
  361.   cool things like write scripts that output .dsc files which can then be
  362.   compiled into custom executables.
  363.  
  364.   To use the command line compiler you must execute the command:
  365.  
  366.     DS(16) /C script-file-path
  367.  
  368.   This will create a matching EXE in the same directory.
  369.  
  370.   Additional command line options are:
  371.  
  372.     /X exe-path    - specifies alternative path for EXE file
  373.  
  374.     /I icon-path   - specifies path of icon to use
  375.  
  376.     /INT           - specifies an integrated EXE to be created
  377.  
  378.     /16            - (32-bit only) creates a 16-bit executable
  379.  
  380.   DS.EXE returns an errorlevel of > 0 if the attempt to create an EXE
  381.   fails. DS16.EXE gives no indication of failure as a 16-bit Windows
  382.   program cannot pass an errorlevel value, so it is advisable to delete
  383.   the EXE, if it exists, before running the command line compile, and
  384.   then test for its existence on completion.
  385.  
  386. Changes:
  387.  
  388. * Fixed bug causing assignments of strings terminating with a space to be
  389.   null.
  390. * Improved the behavior of the Dialog Editor.
  391. * (16-bit) Fixed bug that caused dialogs to have no minimize button.
  392. * (16-bit) Fixed bug in @VOLINFO with flag N.
  393.  
  394. Changes in version 2.10
  395. -----------------------
  396.  
  397. New features:
  398.  
  399. * Included a Tip of the Day at start-up to inform users of tips and
  400.   featurees.
  401. * Made improvements to the editor include a user-definable tab interval
  402.   and a Smart Enter that starts a new line on the same column as the line
  403.   above.
  404. * The IDE can now optionally create integrated EXE files with the
  405.   run-time engine bound in.
  406. * (16-bit) Included a help contents browser with similar functionality to
  407.   that included with Windows 95.
  408. * Added @NUMERIC function to test whether a string is a valid number.
  409. * Added @HEX function and support for hexadecimal arithmetic (hex numbers
  410.   must be prefixed by a $ character.)
  411. * Added @ESC function to generate an Escape character (equivalent to
  412.   @CHR(27)).
  413. * Added @MSGBOX function which enables you to use the full range of
  414.   Windows message box types.
  415. * Added new window information functions @WINTEXT, @WINCLASS, @WINATPOINT.
  416. * Added WINDOW SETTEXT command to set the text of a window control.
  417. * Added WINDOW CLICK and WINDOW RCLICK commands to simulate mouse clicks on
  418.   a specified window.
  419. * Added DLGTYPE NOSYS and NOMIN to hide the system menu and minimize
  420.   button.
  421. * Added CLICK events for CHECK, COMBO, LIST and RADIO dialog elements
  422.   so an event can be triggered by making a selection.
  423. * Added EXIT events for COMBO and EDIT dialog elements so an event can be
  424.   triggered on leaving the control.
  425. * Added LIST LOADTEXT command to allow text embedded in a script to be
  426.   loaded into a string list.
  427. * Added WINHELP command to enable the Windows help system to be used by a
  428.   DialogScript program.
  429. * Added STOP command (unconditional halt, even within GOSUB).
  430. * Implemented extension interface. An additional command and function can
  431.   be added by means of a specially-written DLL.
  432.  
  433. Changes:
  434.  
  435. * Updated the Window Spy to give more information relating to the enhanced
  436.   window functions, such as the mouse position.
  437. * Programs now search their own directory as well as the current directory
  438.   for files without a full path name that are loaded from a script.
  439. * Increased the number of string lists allowed from 4 to 9.
  440. * The @CLICK function now accepts an argument of flags B, R, X, Y returning
  441.   multiple values which can be separated using PARSE. The previous format
  442.   is still accepted.
  443. * Enhanced the @WINEXISTS function to detect the existence of child
  444.   windows.
  445. * Enhanced the @SUM function so it can now sum an unlimited list of
  446.   arguments.
  447. * Fixed problem with @NEXT leaving OK unchanged rather than setting it to
  448.   True.
  449. * Fixed the problem with DIALOG CLOSE destroying the dialog before the
  450.   script finishes when run in the debugger.
  451. * Fixed the problem with trailing spaces on a command line causing
  452.   inconsistent behavior between debugger and run-time.
  453. * Fixed the problem affecting users of some European keyboards in which
  454.   characters generated by pressing the right-hand shift key were not sent
  455.   correctly by Window Send.
  456. * (16-bit) Fixed problems affecting commands and functions that access the
  457.   Registry.
  458. * (16-bit) LIST COPY and LIST PASTE now no longer restricted to a maximum
  459.   255 characters of text.
  460. * (16-bit) Fixed problem with Dialog Editor help not appearing when
  461.   running under Windows 3.1.
  462. * Fixed several problems with Icon Editor, such as Undo not working.
  463. * Fixed some bugs in the Dialog Editor.
  464. * Dialog Wizard now generates code for all events used by the dialog
  465.   without the need to manually refresh the dialog before exiting.
  466. * Improved the error checking and added additional error messages.
  467.  
  468. Changes in version 2.05
  469. -----------------------
  470.  
  471. Changes:
  472.  
  473. * (16-bit) Fixed bug affecting Alt-keys in WINDOW SEND.
  474. * Fixed bug in @NAME function (returned null if no period in filename.)
  475. * Fixed some problems with dialog editor.
  476.  
  477. Changes in version 2.04
  478. -----------------------
  479.  
  480. Changes:
  481.  
  482. * (16-bit) Fixed bug which made RUNM, RUNZ, RUNH all have the same effect
  483.   as RUN.
  484.  
  485. Changes in version 2.03
  486. -----------------------
  487.  
  488. New features:
  489.  
  490. * The OPTION PRIORITY command lets you set the priority level of your
  491.   programs.  (32-bit only)
  492. * The OPTION SKDELAYcommand lets you add a delay between characters sent
  493.   using the WINDOW SEND command.
  494. * The RUN and SHELL commands have an extra optional priority level
  495.   parameter.  (32-bit only)
  496. * In the REGISTRY command and the @REGREAD function you can now use the
  497.   STATS root key to access the Windows performance statistics under
  498.   Registry key HKEY_DYN_DATA.  (32-bit only)
  499.  
  500. Changes:
  501.  
  502. * Fixed problem with 32-bit Dialog Editor which caused incorrect wrapping
  503.   of dialog elements when inserting to the editor.
  504. * Fixed bug in Dialog Editor whereby value field clears when value of
  505.   RADIO dialog element is changed.
  506. * Fixed bug in Dialog Editor that caused default style names to always be
  507.   STYLE1.
  508. * Fixed bug in 16-bit runtime that caused first command line parameter
  509.   passed to an EXE program to be lost.
  510. * Fixed problem that caused 'Unable to run EXE' or 'Sharing violation'
  511.   messages on some systems.
  512. * Default INI file handling has been changed to use DS16.INI instead of
  513.   DEFAULT.INI for compatibility with the 16-bit version.
  514.  
  515. ===========================================================================
  516. S.A.D.E. s.a.r.l., 94-96, rue Victor Hugo 94200 Ivry-sur-Seine, FRANCE
  517.  
  518.         Find us on the World Wide Web at: http://www.dialogscript.com/
  519.